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VERSION 972 — -features added or changed since Swyftcard version B2Q. 
Jonathan Sand -and Dave Lavond 
30 AUGUST 1985 



New key locations 

There are now only -five commands. They are assigned to new keys: 

Control key Rout i ne 

A Insert 

D Send 

G Calculate 

N Print 

L Disk 



Creeper cursor 

H there is no selection, pressing (and letting go of) the le-ft leap key will 
ffiove one character to the left; pressing (and letting go of) the right leap key 
will move one character to the right. This is fondly called creeping. If 
there is a selection, pressing the left leap key unhighlights the text and 
leaves the cursor at the left end of the selection; pressing the right leap key 
unhighlights the text ar.d leaves the cursor at the right end of the selection. 
Creeping is useful for adjusting the size of the selection. Creeping always 
leaves the cursor collapsed. Creep is as fast as possible. 



Leapi ng 

If you already have a selection and you start Leaping left, the cursor will now 
land on a pattern within the selection first, as opposed to after exhausting 
the locations of that pattern outside the selection. 

Leap will not miss pattern characters even if you type fast in a large text. 
Care must be taken now to make sure that you hold the Leap key down until the 
pattern is found or else the last character or two will be inserted into the 
text. 

Leaping is very fast. Try it. 



Word Wrap 

A word at the right end of the screen will wrap to the next line if it is 
followed by two spaces, when there is only room for one or none. A third 
space, however, will wrap to the following Iine,,J> 
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Disk 

The Disk command will always save the text to disk no matter what change or 
lack of change has been made t'o the text. 

You can now visually tell that you have saved a text. The rate at which the 
cursor blinks is doubled after a save. It slows back to the normal rate after 
you add or delete characters. 

The Get command is no longer. 

Drag forward has been added. To use Drag forward, the current text is saved 
using the Disk Command. The passage of text to be copied to another disk is 
selected, the destination disk then inserted in the drive, and the Disk CDfltnisnd 
used. The appearance of the Swyf tcard message indicates that the selection is 
being Dragged. The selected text will be inserted into the destination text 
where the cursor had been when the disk was saved. This final text can then be 
saved to the disk with another Disk command. 

The Disk command is now faster because it removes the gap prior to saving the 
text and restores the gap when loading text. Only the text is placed on the 
disk. This means that text made with previous versions cannot be accessed by 
the Disk command. Instructions for updating old text will be available. 

The ProDos conversion disk is now available. 

If the text is empty and an Apple disk is in the drive, then the Disk command 

hi LjUUU iL. 

After using an Apple disk, Swyftcard can be rebooted by placing a text disk in 
the drive and pressing the control open-apple and reset keys. 



Reassignable keys 

All control keys (alphabetical, A , -, 3, and \) can be assigned to execute code 
at any address. Multiple keys can be assigned to a single routine. The code 
must be in the high 64K bank when using the Disk based version, and in the law 
64K in the Ron based version. A Magic number in key translation table, when 
modified, reassigns all keys to their original routines. There are extensive 
instructions later in this handout. The address of the bottom of the text area 
can be adjusted up or down within the decimal range, 5632 tD -19757, by using 
BASIC to store this value in BT7.. The algorithm which moves the text will 
neither destroy text nor set the bottom too low. See the instructions which 
f ol 1 ow. 
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Insert 

When text is nearly full and the user Inserts enough text to fill all available 
space then the system inserts the text, empties the cut buffer,; and beeps. 
Further attempts to Insert will cause a beep because the cut buffer is empty. 
Insert is now faster. 



Send 



A user can tell if the text he is sending over a modem is being received by a 
Swyftcard by sending controI-Z control-C: the receiving Swyftcard responds with 
the message "SWYFT", preceeded and followed by carriage returns. 

Controi-6 received over the modes! will cause the receiving user to hear onE 
bell; no character is entered into the text. 

A line feed or carriage return or both can be Sent by using the BASIC variable 
LEI. Add the first character to 256 times the second character. A carriage 
return (13) and the line feed (10), yields LE'/.=2573. The default is -1. 

When a character is received and the text is full, the bell rings until the 
delete key is pressed. 

You can now Send at 153,600 baud! Unfortunately, text is received and display 
at only 4,800 baud, because the receiving computer must update its screen. The 
baud rates and the asscociated value of SE7. are tabulated here: 



baud 



BE 7. value 



300 
1200 
2400 
4300 
9600 
19,20 
153,600 
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Print 

The page length can be changed with the BASIC variable PL*/.. Swytfcard makes 
sure that PL7. is big enough -for a top (AB%) and bottom (BE7.) margin and at 
least one line of text. 

The maximum number of pages was 125; it is now 200. 

Underlining is now available. It is toggled on and off in the text by the 
underline character. The underline character is not printed; a space is 
substituted -for it in the printout. Underlining is also turned off by a pair 
of carriage returns or by a pagebreak (actual or implied). A string of 
underlines is printed as a solid underline, except that the first and last 
underline are, for consistency, printed as blanks. 

The BASIC strings US$ and UE* are passed to the printer to turn underlining on 
and off, respectively. The user customizes them for their own printer. They 
can be up to 5 characters each. The first element in UE* is a group flag. If 
each character is individually underlined, by backspacing, then the group flag 
should be set to CHRt-(O). If underlining is done automatically by the printer, 
set the group flag to CHR$(1>, as with the EPSON. 

US$=CHR*(27>+CHR*<45)+CHR$(49> default (for the EPSON printer) 

UE*=CHR*(i)+CHR* (27) +CHR* (45) +CHR* (48) 

l!S* = CHR*(95)+CHR*(8) (for other printers) 

UE*=CHR*(0) 

BASIC 

The BASIC commands RUN and NEW now delete all user strings except printer 
strings for initialization, underline on and underline off. If you have 
configured for your printer, RUN and NEW will no longer return you to the 
default printer configuration! You no longer have to use BOTD to avoid this. 

A BASIC program which reads or writes Swyftcard variables or strings must be 
executed with a SOTO statement. RUN clears all of the variables and strings. 

A handy BASIC command to observe the contents of strings is the following, note 
the in MID$. For example, substitute PR* for string-name* below to see 

the string used for printer initialization; 

FDR I = 1 TO LEN(string-namel) : ? ASC (MID* (string-name* , 1 , 1 ) ) : NEXT I 

The default BASIC strings, for the EPSON FX-80 printer, are: 

PR*=CHR*(0)+CHR*(0)+CHR*(5)+CHR*(27)+CHR*(77)+CHR*(27)+CHR$(108) +CHR$(8) 
US*=CHR* (27) +CHR* ( 45) + CHR* (49) 
UE*=CHR* ( 1 ) +CHR* (27) + CHR* (45) +CHR* ( 48 ) 

For other printers, the underline strings that will always work are: 

U5* = CHR*(95)+CHB.*(3) 
UE*=CHR*(0) 
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Reassigning the Key Commands 

All control keys execute a SwyftCard command. They can be reassigned with 
simple BASIC statements. The , "Commands are executed through twq-tables, the 
translation and execution tables, at decimal 5536 and 5568, respectively. As 
only some of the control keys are assigned, both tables are only sparsely 
populated: 



Control 


Translation 


Ex 


ecuti 


on 


Exscuti on 


Name of 




Rout i ne 




Char ASCII 


Table address 




Index 


Table Add 


r ess 


Routine 




Address 




Delete 


5536 






i 




5570 




DELETE 




58263 




A 1 


C- C T "T 

Jdj/ 






7 




5582 




PASTE 




58622 




D 4 


5540 






5 




jj/d 




SEND 




59B59 




G 7 


5543 






o 

u 




5584 




BASIC 




63510 




Tab, I 9 


5545 






27 








TAB 




58483 




L 12 


5548 






4 




5576 




D I SK 




64B54 




N 14 


5546 






7 




5572 




PRINT 




60745 




Z 26 


5562 






12 




5592 




CONTROL 




59817 




Escape, C 27 


CC / 7 

Ju'tl 1 






23 




5624 




ENTER 




58464 

















5568 




N00P 




54607 












29 




5626 




magic # 




12855 




1 2 


•7 






4 




c 

J 




6 




7 




The control key (column 


1) 


l 5 r 


ec s i 


v s d , by 


the 


SwyftCard, 


as its ASCII 




value (column 2 


) . This value 


i 


s first converted to 


an index ( 


CO 


iumn 4) by 




using the value 


as an offset 


i n 


to the tr 


a n s 1 a t i 


on table (column 


3) . Since e 


ach 


element in the 


execution 


tabl 


e 


is 2 


bytes, the 


index 


is doubled 


to use as an 




offset into the 


ex ecuti on 


tab 


i e 


to yield 


the table address (column 5) 




containing the 


executi on 


addr 




s of 


the 


r outi ne 


(column 6 and 


75 


. All value 


3 


in column 7 change with e 


ach 


ver si on 


Control 


keys 


not incluc 


ed 


in the a b o v 


o 


table have been 


assigned 


an i 


n d e x o f 


vi 


hich ex 


scute 


s N00F. L 


n i 


n c I u d e d i n d i 


C95 



also execute N0DP 



bO , 



when you press the control N key, the Swyftcard converts it to an 



index of 2, which it got from location 5546. The index is used to locate, at 
5572, the address of the PRINT command, which is executed. 

Since these tables are located in RAM, their values can be modified so as 
to reassign keys to new commands. For instance, control P can be assigned to 
also execute the PRINT command, in addition to control N. Alternatively, 
control P can be reassigned to a custom program you write that, say, replaces 
one word with another (actually not impossible...), or that does a Sort. 

At the end of the execution table there is a magic number, related to the 
version number. If this number is changed, the table will be reinitialized, 
either after a BASIC command, or after pressing control Reset. 
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So, if. you want to assign that control P key to the print command, you 
place, using a BASIC statement, the index of the print command, 2, into the 
16th position .(control P) past the beginning of the translation table: 

75536+16 = 5552 

Try changing it and using the control P key: 

PDKE5552,2 

On the ether hand, if you want to assign the control P key to a completely 
new routine, you must find an unused indE;;, say 10, and store that at 5552: 

P0KE5552, 10 

At this point, since the index 10 is assigned to a NOQP, the control P key 
will once again be inert. To assign index 10 a routine, you must store the 
address in the 10th 2 byte position past the beginning of the execution table: 

72*10+5568 = 55GB 

Let's store the warm start routine (53760), Since the POKE command only 
stores a byte at a time, we have to figure out the value of the high byte and 
the low byte. The high byte is highest integer lower than 53760 over 256: 

753760/256 = 210 

The low byte is the remainder: 

753760- (256*210) = 

P0KE55B8,0 (low byte) 

P0KE5589,210 (high byte) 



The Set command can be reassigned to the control R key. The Set routine 
is at 6359B; the high byte is 248, and the low byte is 110. The control key is 
already assigned an index of 6. The execution table location for this index is 
5580. The BASIC statement is thus: 

P0KE55B0, 110: P0KE5581 ,248 



If you make a mistake, you can force the Swyftcard to reinitialize the key 
command tables by storing a zero at location 5626: 

P0KE5626,0 

Remember not to reassign the key that performs BASIC without first 
assigning another key to it... 
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This BASIC 


program 


will print the current key assignments. Below it is 


its output. 


May 


all of 


your reassi gnnients be good ones. 


10 ?:?"ASC trans 


i ndex 


exec routine":? 


20 FOR I = 


TO 


31 




30 fi=5536+I 








40 B=PEEK(A) 








50 C=556B+(2*B) 






fiy J.' - r t £. h l L. J + 


\ jL j 


6*PEEK (C+l ) ) 


7 a n t ■ • "> ■ 


n , 
» 








( 








1! , 
1 






< ft A 1 p . . n » 


II , 

) 






1 i V : U 








f h(\ KIT V T 
i i. U N L. A 1 








I OU t IN 1/ 








A Su trans in 


o e x 


9 K S C 


r o u w i n s 


ft CCT/ 


1 


rein 
O u / y 


D Z a -J 


1 JJO/ 


7 

/ 






*i JJjg 


ft 


cc / n 
JJDD 


J T U V / 


J J i 7 


ft 


cc / n 
JJDO 


c< A J ft 7 
J 7 U / 


A c c A ft 


C 
J 


CC70 


ennen 
J7QJ7 


J Jjl 1 


A 
l> 


JJ3S 




i. =: c . a r > 


A 

u 


c ^ L D 


iJ 7 O / 


7 





uJSl 


17C I ft 

a w w i U 


P AA 


ft 


^ An 


c * / d 7 


7 u □ t J 


i. / 




ten a n-T 
JD'tSO 


1 A cc « / 
1 V jtQ 


ft 
IJ 




c a 1 A 7 


11 Jjl/ 





rr; n 

yJQj 


K A i. ft 7 




7 


c - 7 J 


/ fl ntr j 




n q 




i norc 


1 A =■ c ^ ft 


*■ 


J J / i 


i. A 7 A cr 
O V / 7 J 







5568 


54607 


16 5552 





556B 


54607 


17- „ 5553" ^ 





5568 


54607 


IB , 5554 





5568 


54607 


19 5555 





5568 


54607 


20 5556 





5568 


54607 


21 5557 


o 


556B 


54607 




o 


uJOD 


J f '.' / 




ft 


5568 


54607 


24 5560 





5568 


54607 


25 5561 





5568 


54607 


26 5562 


12 


5592 


59817 


27 5563 


28 


5624 


5B464 


2B 5564 


o 


5568 


54607 


29 5565 


9 


5586 


55976 


30 5566 


T 

•J 


5574 


54607 


31 5567 


11 


5590 


54607 








EM$ 
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